/*
 *      Copyright (c) 2018-2028, Chill Zhuang All rights reserved.
 *
 *  Redistribution and use in source and binary forms, with or without
 *  modification, are permitted provided that the following conditions are met:
 *
 *  Redistributions of source code must retain the above copyright notice,
 *  this list of conditions and the following disclaimer.
 *  Redistributions in binary form must reproduce the above copyright
 *  notice, this list of conditions and the following disclaimer in the
 *  documentation and/or other materials provided with the distribution.
 *  Neither the name of the dreamlu.net developer nor the names of its
 *  contributors may be used to endorse or promote products derived from
 *  this software without specific prior written permission.
 *  Author: Chill 庄骞 (smallchill@163.com)
 */
package org.springblade.modules.admin.service;

import org.springblade.core.tool.api.R;
import org.springblade.modules.admin.dto.CheckPlanSetTimeDTO;
import org.springblade.modules.admin.vo.MaintainPlanStatisticsVO;
import org.springblade.modules.admin.dto.CheckPlanCloseDTO;
import org.springblade.modules.admin.dto.CheckPlanSendDTO;
import org.springblade.modules.admin.dto.MaintainPlanCheckBatchDTO;
import org.springblade.modules.admin.dto.MaintainPlanCheckPageDTO;
import org.springblade.modules.admin.entity.MaintainPlanCheck;
import org.springblade.modules.admin.vo.MaintainPlanCheckVO;
import org.springblade.core.mp.base.BaseService;
import com.baomidou.mybatisplus.core.metadata.IPage;
import org.springblade.modules.admin.vo.MaintainPlanPageVO;
import org.springblade.modules.admin.vo.check.ProblemPlanVo;
import org.springblade.modules.admin.vo.check.ProblemResultVo;
import org.springblade.modules.admin.vo.check.ProblemSearchVo;
import org.springblade.modules.admin.vo.check.ProblemStatusVo;
import org.springblade.modules.admin.vo.plan.AffairListVo;
import org.springblade.modules.admin.vo.plan.CheckChildPlanVo;
import org.springblade.modules.admin.vo.user.UserAffairAndCheckVo;

import java.util.List;

/**
 * 质检工单表 服务类
 *
 * @author ysq
 * @since 2023-11-27
 */
public interface IMaintainPlanCheckService extends BaseService<MaintainPlanCheck> {

	/**
	 * 自定义分页
	 *
	 * @param page 分页
	 * @param maintainPlanCheck 质检工单表
	 * @return IPage<MaintainPlanCheckVO>
	 */
	IPage<MaintainPlanCheckVO> selectMaintainPlanCheckPage(IPage<MaintainPlanCheckVO> page, MaintainPlanCheckVO maintainPlanCheck);

	/**
	 * 新增质检工单
	 * @param maintainPlanCheckBatchDTO 质检工单批量新增DTO
	 * @return 当是单个新增的情况，返回新增的工单id
	 */
    Long addBatch(MaintainPlanCheckBatchDTO maintainPlanCheckBatchDTO);

	/**
	 * 根据工单id查询工单详情
	 * @param planId 工单id
	 * @return 工单详情
	 */
	MaintainPlanCheckVO selectMaintainPlanDetailById(Long planId);

	/**
	 * 根据条件分页查询工单列表
	 * @param maintainPlanCheckDTO 查询条件
	 * @return 工单列表
	 */
	IPage<MaintainPlanPageVO> pageByCondition(MaintainPlanCheckPageDTO maintainPlanCheckDTO);

	/**
	 * 质检工单抬头统计
	 * @return 统计结果
	 */
	MaintainPlanStatisticsVO statistics();

	/**
	 * 根据条件查询工单列表
	 * @param maintainPlanCheckDTO 查询条件
	 * @return 工单列表
	 */
    List<MaintainPlanPageVO> listByCondition(MaintainPlanCheckPageDTO maintainPlanCheckDTO);

	/**
	 * 质检工单批量任务指派/转派
	 * @param checkPlanSendDTO 指派/转派入参
	 * @return 是否成功
	 */
	Boolean assign(CheckPlanSendDTO checkPlanSendDTO);

	/**
	 * 质检工单批量关闭
	 * @param checkPlanCloseDTO 关闭入参
	 * @return 是否成功
	 */
	Boolean closeBatch(CheckPlanCloseDTO checkPlanCloseDTO);

	/**
	 * 质检工单批量设置时间
	 * @param checkPlanSetTimeDTO 设置时间入参
	 * @return 是否成功
	 */
	Boolean setExecuteTime(CheckPlanSetTimeDTO checkPlanSetTimeDTO);

	/**
	 * 查询子工单
	 * @param planId 工单id
	 * @param typeStatus 当前状态，后期扩展状态
	 * @return 数据集
	 */
	List<CheckChildPlanVo> getCheckChildPlanList(Long planId, Integer typeStatus);


	/**
	 * 获取质检工单的问题点列表工单
	 * @param problemSearchVo 查询条件
	 * @return 数据集
	 */
    IPage<ProblemResultVo> getProblemResultList(ProblemSearchVo problemSearchVo);


	/**
	 * 获取问题统计数据状态
	 * @return 数据集
	 */
	ProblemStatusVo getProblemStatus();

	/**
	 * 获取子工单信息
	 * @param planId 工单id
	 * @return 数据集
	 */
	CheckChildPlanVo getCheckChildPlanVo(Long planId);

	/**
	 * 问题点excel下载
	 * @param problemSearchVo 查询条件
	 * @return 数据集
	 */
	List<ProblemPlanVo> downProblemList(ProblemSearchVo problemSearchVo);


	/**
	 * 获取人员的待开始和进行中的工单
	 * 用于用户离职人员的校验
	 * @param userId 用户iD
	 * @return 数据集
	 */
	UserAffairAndCheckVo getPlanUserList(String userId);

	/**
	 * 获取执行人的工单
	 * 获取人员的待开始和进行中的工单
	 * 用于用户离职人员的校验
	 * @param userId 用户id
	 * @return 数据集
	 */
	List<MaintainPlanPageVO> getPlanListOfUserId(String userId);

}
